package nameless.aistudy.domain.service.subjects.english.reading;

import org.springframework.web.servlet.mvc.method.annotation.SseEmitter;

public interface EnglishTranslateAIService {

    /**
     * 将英文文本翻译为中文
     *
     * @param english 待翻译的英文文本
     * @param requirements 翻译要求数组，可为空
     * @return 翻译后的中文文本
     */
    String translateEnglishToChinese(String english, String[] requirements);

    /**
     * 将英文文本翻译为中文（流式响应版本）
     *
     * @param english 待翻译的英文文本
     * @param requirements 翻译要求数组，可为空
     * @return Server-Sent Events发射器，用于流式返回翻译结果
     */
    SseEmitter translateEnglishToChineseStream(String english, String[] requirements);

    /**
     * 将中文文本翻译为英文
     *
     * @param chinese 待翻译的中文文本
     * @param requirements 翻译要求数组，可为空
     * @return 翻译后的英文文本
     */
    String translateChineseToEnglish(String chinese, String[] requirements);

    /**
     * 将中文文本翻译为英文（流式响应版本）
     *
     * @param chinese 待翻译的中文文本
     * @param requirements 翻译要求数组，可为空
     * @return Server-Sent Events发射器，用于流式返回翻译结果
     */
    SseEmitter translateChineseToEnglishStream(String chinese, String[] requirements);

}
